home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / clipper / acc86.zip / ACCI86.DOC next >
Text File  |  1987-10-23  |  49KB  |  1,950 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                                   ACCI86.LIB
  16.                                  USERS MANUAL
  17.  
  18.  
  19.                            A Clipper Function Library
  20.   
  21.                                   Version 1.00
  22.                                     10/21/87
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.             Copyright (c)  Advanced Computer Consultants, Inc.  1987
  51.                                  P.O. Box 462
  52.                              Ridgeland, MS  39158
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                ACCI86.LIB
  59.                             TABLE OF CONTENTS
  60.  
  61.  
  62.  
  63.      Page       Contents
  64.  
  65.        1 ...... License
  66.        2 ...... Warranty
  67.        3 ...... Registration Order Form
  68.        4 ...... Overview
  69.  
  70.  
  71.                 Chapter 1    File Open/Close Functions
  72.  
  73.        6 ...... AC_OPEN()    - Allows setting of sharing and access mode
  74.        7 ...... AC_FOPEN()   - opens file with Deny None mode and 
  75.                                   Read/Write access as default
  76.                 AC_CREAT()   - allow setting of file attributes
  77.                 AC_FCREA()   - creates file with default attribute
  78.        8 ...... AC_CLOSE()   - closes an open file
  79.                 AC_UNIQ()    - create unique file using INT 5A
  80.  
  81.  
  82.                 Chapter 2    File I/O Functions (read and write)
  83.  
  84.        9 ...... AC_GETS()    - read string from file
  85.                 AC_PUTS()    - write string to file
  86.                 AC_GETB()    - read one byte as string from file
  87.       10 ...... AC_PUTB()    - write string as one byte to file
  88.                 AC_GETI()    - read integer from file
  89.                 AC_PUTI()    - write integer to file
  90.       11 ...... AC_GETD()    - read date from file
  91.                 AC_PUTD()    - write date to file
  92.                 AC_GETZ()    - read a ASCII 0 terminated string from file
  93.  
  94.  
  95.                 Chapter 3    File Pointer Functions
  96.  
  97.       12 ...... AC_MVPTR()   - move file pointer, all 3 modes
  98.                 AC_GOTOP()   - goto beginning of file
  99.                 AC_GOBOT()   - goto end of file
  100.       13 ...... AC_BOF()     - is BOF
  101.                 AC_EOF()     - is EOF
  102.                 AC_POSIN()   - current position
  103.       14 ...... AC_SKIP()    - move +- bytes
  104.                 AC_FSIZE()   - file length (size)
  105.  
  106.  
  107.  
  108.  
  109.      Page       Contents - Continued
  110.  
  111.  
  112.  
  113.                 Chapter 4    File Attribute Functions
  114.  
  115.       15 ...... AC_GATTR()   - read file attributes
  116.                 AC_ISRO()    - is read only file
  117.                 AC_ISHID()   - is a hidden file
  118.       16 ...... AC_ISSYS()   - is a system file
  119.                 AC_ISSUB()   - is a subdirectory
  120.                 AC_ISARC()   - is archive bit set
  121.       17 ...... AC_PATTR()   - write file attributes
  122.                 AC_MKRO()    - make file read only 
  123.                 AC_MKHID()   - make file hidden
  124.       18 ...... AC_MKSYS()   - make file system
  125.                 AC_MKARC()   - set archive bit 
  126.  
  127.  
  128.                 Chapter 5    File Time/Date Stamp Functions()
  129.  
  130.       19 ...... AC_GTIME()   - read file time stamp
  131.                 AC_GDATE()   - read file date stamp
  132.                 AC_PTIME()   - write file time stamp
  133.       20 ...... AC_PDATE()   - write file date stamp
  134.                 AC_PTD()     - write both time and date stamps
  135.  
  136.  
  137.                 Chapter 6    Misc. DOS Functions 
  138.  
  139.       21 ...... AC_QUIT()    - quit the program passing DOS an exit code
  140.                 AC_RETCD()   - get from DOS the exit code 
  141.                 AC_COMIT()   - Comit file using INT 68
  142.       22 ...... AC_DOS()     - returns the DOS version as a string
  143.  
  144.  
  145.                 Chapter 7    Other Functions
  146.  
  147.       23 ...... AC_DIAL()    - dial a given telephone number string
  148.                 AC_MODEM()   - set parameters for AC_DIAL()
  149.                 AC_SETM()    - also sets parameters for AC_DIAL()
  150.       24 ...... AC_STCL()    - set parameters on the constant display clock
  151.                 AC_CLSET()   - simpler method to set the clock
  152.       25 ...... AC_CLON()    - turn on the constant display clock
  153.                 AC_CLOFF()   - turn off the constant display clock
  154.  
  155.  
  156.  
  157.  
  158.      Page       Contents - Continued
  159.  
  160.  
  161.  
  162.                 Chapter 8    Error Recovery
  163.  
  164.       26 ...... OVERVIEW
  165.                 AC_ERROR()   - returns DOS or ACCI error number
  166.       27 ...... DOS ERROR CODES
  167.       29 ...... ACCI ERROR CODES
  168.  
  169.  
  170.                 Chapter 9    Standalone Utilities
  171.  
  172.       30 ...... FRMSTRUC     - prints the structure of a Report .FRM file
  173.  
  174.  
  175.                                   LICENSE
  176.  
  177.     "Programs" shall mean the computer software contained in the ACCI86.LIB
  178.     file and the accompanying documentation.
  179.  
  180.     The Programs are not in the public domain, nor are they free software.
  181.  
  182.     Copyright (C) 1987 ADVANCED COMPUTER CONSULTANTS, INC.  All rights
  183.     reserved.
  184.  
  185.     Non-registered users are granted a limited license to use the Programs 
  186.     on a trial basis for the purpose of determining whether the Programs
  187.     are suitable for their needs.  Use of the Programs, except for this 
  188.     limited purpose, requires registration.  Use of non-registered copies 
  189.     of the Programs by any person, business, corporation, governmental 
  190.     agency or other entity is strictly prohibited.
  191.  
  192.     All users are granted a limited license to copy the Programs only for the
  193.     trial use of others subject to the above limitations, and also the
  194.     following:
  195.  
  196.         - The Programs must be copied in unmodified form, complete with 
  197.           the file containing this license information.
  198.  
  199.         - The full ACCI86.LIB documentation must be included with the copy.
  200.  
  201.         - No fee, charge or other compensation may be accepted or requested
  202.           by any licensee.
  203.  
  204.     Operators of electronic bulletin board systems (Sysops) may post 
  205.     ACCI86.LIB for downloading by their users only as long as the above 
  206.     conditions are met.
  207.  
  208.     Registration grants a user the following non-exclusive privileges:
  209.         - You may incorporate any of the Programs into software applications
  210.           you develop.
  211.         - You may modify the Programs for the purpose of incorporating
  212.           them into your applications.
  213.         - You may distribute copies of the Programs to the extent they are
  214.           incorporated in your software applications and you have placed
  215.           your own copyright notice on the application.
  216.         - To incorporate the Programs into your application your application
  217.           can not be a library of functions as are the Programs.
  218.         - You may use the Programs as a library on only a single computer
  219.           at one time.  You are not limited by this license as to how many
  220.           copies of your applications incorporating the Programs you may
  221.           distribute.
  222.         - You may purchase for an additional amount a copy of the assembler
  223.           and Clipper source code. (See order form.)
  224.         - The Programs remain the property of ADVANCED COMPUTER CONSULTANTS,
  225.           INC. No amount of modification of the source or rewriting of the
  226.           source code will allow you to consider the resultant source code
  227.           to be your property.
  228.         - Notification of upgrades.
  229.  
  230.     See the registration form for more information on registration, quantity
  231.     purchases and similar topics.
  232.  
  233.                                     - 1 -
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.                                   WARRANTY
  243.  
  244.  
  245.     ADVANCED COMPUTER CONSULTANTS, INC. will replace any disks found to be 
  246.     physically defective within 30 days from date of purchase.
  247.  
  248.     ADVANCED COMPUTER CONSULTANTS, INC. warrants that the Programs will
  249.     perform in substantial compliance with the documentation supplied with 
  250.     the product.  If a significant defect in the product is found, 
  251.     Purchaser will be entitled to a refund.  In no event will such a refund 
  252.     exceed the purchase price of the Programs.
  253.  
  254.     EXCEPT AS PROVIDED ABOVE, ADVANCED COMPUTER CONSULTANTS, INC. DISCLAIMS
  255.     ALL WARRANTIES, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED 
  256.     TO IMPLIED WAR